🎯 目标 (Motivation & Context)

本 PR 落地了网关重构计划的第四步 [EPIC-GW-04]。 为了让 NeoCode 能够作为底座服务于未来的 Web UI、富文本 TUI 等多模态客户端，我们在原有的 IPC 控制面之外，平行增加了一套 网络访问面 (Network Access Plane)。

💡 MVP 设计原则说明：

• 默认安全隔离：网络端点默认死锁绑定在 127.0.0.1:8080，利用操作系统 Loopback 机制进行物理隔离，本期暂不引入复杂的 Token 鉴权体系。
• 协议绝对统一：无论外界是通过 Unix Socket、HTTP POST 还是 WebSocket 连入，底层逻辑全部归一化为标准的 JSON-RPC 2.0，所有入口共享一套鉴权、限流与业务路由。

Closes #304

✨ 主要变更 (Key Changes)

1. 三端点网络骨架 (internal/gateway/network_server.go)

• POST /rpc：标准 HTTP 短连接入口，用于单次指令下发。
• GET /ws：WebSocket 双向长连接入口，支持后续的流式打字机交互。
• GET /sse：Server-Sent Events 单向流入口，针对 MVP 场景（gateway.ping）实现了触发即订阅及自动心跳保活。

2. 核心架构解耦与复用 (internal/gateway/rpc_dispatch.go)

• 抽离出统一的 rpc_dispatch.go 分发器。
• IPC Server 与 Network Server 不再各自为战，彻底消除重复的 MessageFrame 转换与 Error 映射代码。

3. 工程化与治理基线 (Governance)

• CORS 支持：全局注入标准化跨域头并接管 OPTIONS 预检请求，为前端直连铺平道路。
• 优雅退出 (Graceful Shutdown)：通过并发安全的 sync.Mutex 维护长连接池，当进程收到终止信号时，主动切断所有休眠的 WS/SSE 阻塞 I/O，确保 neocode gateway 能够极速退出。
• 修复了 404/405 边缘路由的兜底处理，确保任意错误入口均返回标准 JSON-RPC 格式。

4. 🧹 Chore: TUI Infra 测试修复

• 顺手修复了 internal/tui/infra 中 clipboard 与 image 模块在多平台 CI 下的 flaky 测试遗留问题。

✅ 验收标准 (Acceptance Criteria)

• CLI 支持 --http-listen 参数，网关可同时启动 IPC 与 HTTP 服务而不互相阻塞。
• curl POST /rpc 可成功调用 gateway.ping 并获得标准响应。
• WS 与 SSE 管道测试连通，且进程退出时不会发生 Goroutine 挂死。
• 尝试绑定 0.0.0.0 等非 Loopback 地址时，被安全策略明确拒绝。

🧪 测试与验证结果 (Verification)

• 网络面核心逻辑（包含连接生命周期管理、CORS、长短连接收发）单元测试全量覆盖。

• go test ./... 全仓 0 失败通过。

• 本地冒烟测试指令 (供 Reviewer 验证)：

    # 启动网关
    $ go run ./cmd/neocode gateway
  
    # 1. 验证 HTTP
    $ curl -X POST http://127.0.0.1:8080/rpc -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "gateway.ping", "id": 1}'
  
    # 2. 验证 SSE 心跳
    $ curl -N http://127.0.0.1:8080/sse